package com.huhao.wshare.dto;

import lombok.Data;

/**
 * 自定义API响应结构
 * 仅用于FileController，按需使用
 * @param <T> 响应数据的类型
 */
@Data // 使用Lombok自动生成getter, setter, toString等方法
public class ApiResponse<T> {

    /**
     * 状态码 (例如: 200-成功, 500-服务器错误, 400-客户端错误)
     */
    private int code;

    /**
     * 响应消息 (例如: "上传成功", "文件不能为空")
     */
    private String message;

    /**
     * 响应数据 (例如: 包含URL的Map对象)
     */
    private T data;

    // --- 构造函数 ---
    public ApiResponse(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }

    // --- 静态工厂方法，方便调用 ---

    /**
     * 成功的响应
     * @param data 数据
     * @return ApiResponse
     */
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(200, "操作成功", data);
    }

    /**
     * 成功的响应（自定义消息）
     * @param message 消息
     * @param data 数据
     * @return ApiResponse
     */
    public static <T> ApiResponse<T> success(String message, T data) {
        return new ApiResponse<>(200, message, data);
    }

    /**
     * 失败的响应
     * @param code 错误码
     * @param message 错误消息
     * @return ApiResponse
     */
    public static <T> ApiResponse<T> error(int code, String message) {
        return new ApiResponse<>(code, message, null);
    }
}
